home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Turnbull China Bikeride
/
Turnbull China Bikeride - Disc 2.iso
/
BARNET
/
UTILITIES
/
SPLIT
/
!Help
< prev
next >
Wrap
Text File
|
1995-09-23
|
19KB
|
450 lines
====================
!Split Version 2.12
====================
****************************** Copyright Notice ******************************
* *
* This application is copyright Adam Hamilton. *
* Permission to use, copy, and distribute !Split, for non-commercial *
* purposes, is hereby granted, provided:- *
* *
* • No charge is made other than to cover the cost of the medium. *
* *
* • All files and documents are included in the distribution unaltered. *
* *
* You may upload this software to a Bulletin Board, or include it in *
* your Public Domain library. If you do this, please try and let me *
* know, so I can keep you up to date with any future changes. *
* The authors permission must be obtained before this application is *
* included on any magazine disk, or with any other software. *
* *
* You may not sell this software, or use it otherwise for personal gain. *
* *
* If you change any part of this software, you must obtain permission *
* from the author, before distribution. *
* *
* This program is supplied 'as is' with no guarantee of its suitability *
* for any purpose. I will not be held responsible for any damage arising *
* from the use or misuse of this software. *
* *
* I reserve the right to change these terms and conditions at any time. *
* *
******************************************************************************
Contacting The Author
~~~~~~~~~~~~~~~~~~~~~
Bug reports, comments and any donations may be sent to me, the author,
at this address :-
Adam Hamilton,
23 Northmeadow Road,
Cricklade,
Swindon,
Wiltshire, SN6 6LT,
England.
I may also be contacted by E-Mail: aph@swindon.gpsemi.com
================================================================================
1 Introduction
!Split was written to ease the transportation of large files from one
computer to another. No attempt to compress the file is made, as it is
assumed this has already been done. !Split will split a file into a number
of smaller files, and will join them again when required.
2 How To Use !Split
!Split can be started either by running the application directly or via
a double click on a split file (see section 2.3, 'Joining Files').
2.1 The iconbar menu
Pressing the menu button on the iconbar icon will display a menu.
Info This displays information about the program.
Autoload When joining files, if this option is selected, !Split
will automatically attempt to locate the next part to
join.
Faster If selected, the multi-tasking window will not be
updated with bytes read and written, making the
operation faster. A tick will be displayed when this
option is selected.
Single Task This option will toggle between single and
multi-tasking. A tick will be displayed when this option
is selected.
Quit This will quit the program.
The default action of Autoload, Faster, and Single Task options may be
changed (see section 3, 'Customizing').
2.2 Splitting Files
The split window can be displayed either by clicking on the iconbar icon
with select, or by dragging a file to the iconbar icon. Figure 1 shows an
example of the split window. Please note, you may open and close filer
windows, or change floppy disks between saving.
---------------------------------------------
| ----------------------------- |
| Source |s::IDEDisc5.$.Music.RaveAlert| |
| ----------------------------- |
| ---------- - |
| Filesize | 1423| K | | |
| ---------- - |
| ---------- - |
| Filename | RaveAler | |€| Single save |
| ---------- - |
| ------- ------- |
| | Close | | Split | |
| ------- ------- |
---------------------------------------------
Figure 1: Split window
2.2.1 Source
Enter the filename for the file you want to split, or simply drag
the file to the split window. If you drag, the Filename field will
automatically get filled in, although you can still change it if you
wish.
2.2.2 Filename
This is the 'base' filename to be used for each part the file is split
into. Using the example above, the base name is RaveAler so the parts
will be named RaveAler01, RaveAler02, ... etc.
2.2.3 Filesize
This is the maximum file size in K (1024 bytes), that you want each
part to be saved as. You may either type the size into the text icon,
or press the select or menu mouse buttons on the menu icon opposite.
You may then choose from one of the sizes in the menu. The default
size and the contents of the menu can be customized (see section 3,
'Customizing').
2.2.4 Single save
If this option is set, !Split will automatically save all parts to the
same directory, only one drag is needed. This option may be switched
on or off during saving. The default setting for this option may be
customized (see section 3, 'Customizing').
2.2.5 Close
Pressing this button will close the split window. If splitting has
started, closing the split window will not affect this process.
2.2.6 Split
Pressing Split will open the `save as' window, shown in figure 2 below,
(if all the parameters have been set correctly), prompting you to drag
the icon to a directory window. If the Single Task option has not been
selected from the iconbar menu, then a transfer window will be
displayed and the splitting process will begin (see section 2.4,
'The Transfer Window'). If you only want to save certain parts, then
use the Skip button to miss out the current part.
-------------------------
| ----- |
| | | |
| | | |
| ----- |
| ------------- |
| | RaveAler01 | |
| ------------- |
| -------- -------- |
| | Cancel | | Skip | |
| -------- -------- |
-------------------------
Figure 2: Saveas window
2.3 Joining Files
The join window can be opened either by clicking on the iconbar icon with
adjust, double clicking or dragging to the iconbar icon, a file of type
'Split'. If you opened the window with the adjust mouse button, you must
double click or drag the first file to the join window. If you maximize
the join window you will see some short hints to help you along. Figure 3
shows an example of the join window.
-----------------------------------------------------------
| Save as | Info |
| ----- | |
| | | | Part 1 of 2. |
| | | | Drag file to directory window. |
| ----- | |
| ------------- | |
| | RaveAlert | | |
| ------------- | |
| -------- -------- | Using buffer size of 192K |
| | Cancel | | Save | | |
| -------- -------- | |
-----------------------------------------------------------
Figure 3: Join window
Once !Split has the first part of the file to join, you need to tell it
where to save the joined file. To do this, simply drag the file icon to
the directory where you want it saved, or type the path into the text icon
and press Save. Pressing Save without a full path in the text icon, will
save the file in the current directory.
If the Autoload option is on, !Split will automatically look for the next
part to join. If it is found, joining will continue, otherwise joining
will be suspended and you will need to either double click on the next
part (filetyped as 'Split'), or drag it to the join window or the iconbar
icon.
If single tasking is not enabled, the transfer window will be displayed
(see section 2.4, 'The Transfer Window').
If Cancel is pressed, joining is aborted and the window closes.
2.4 The Transfer Window
The transfer window is displayed when splitting or joining has started
and multi-tasking is enabled. Figure 4 shows an example of the transfer
window.
-------------------------------------------
| ------------------------------------- |
| | Reading | |
| |sc5.$.!C.Source.Split.test.RaveAler01| |
| ------------------------------------- |
| 589824 bytes read |
| 458752 bytes written |
| ------- -------- -------- ------- |
| | Abort | | Faster | | S-Task | | Pause | |
| ------- -------- -------- ------- |
-------------------------------------------
Figure 4: Transfer window
The transfer window shows what the program is doing and on what file, it
also shows the number of bytes read and written. The function of the
buttons are outlined below:-
Abort This will abort the operation, and close the window.
Faster/Slower This will disable/enable the display of information in
the window, resulting in slightly faster operation. This
lasts for the duration of the current file operation.
S-Task This will put the program into single task mode for the
duration of this file operation only.
Pause/Continue This will pause/resume the transfer operation.
Please note, once in single task mode, control is removed from the
transfer window.
3 Customizing
!Split may be customized is several ways.
3.1 Changing the buffer size
The buffer size used to temporarily store data can be changed (this will
slightly affect the speed of the program). To do this, open the
application directory by holding down the Shift key and double clicking on
the !Split icon. Once inside, load the !Run file into your favourite text
editor.
To change the maximum buffer size, increase or decrease the value of the
-max option on the WimpSlot command. For example:-
WimpSlot -min 96k -max 640k
Please do not change the -min size.
3.2 Iconbar menu
The default status of the Autoload, Faster, and Single Task options in the
iconbar menu may be set. To do this, load the !Run file into a text editor
(as above), then add or remove the following commands in the line
beginning with: Run <Split$Dir>.!RunImage
-autoload This will default the Autoload option to on.
-faster This will default the Faster option to on.
-singletask This will default the Single Task option to on.
For example, if I want !Split to start up with only the Faster option
selected, I would have the following line:-
Run <Split$Dir>.!RunImage -faster %*0
Please note, as the Faster and Single Task options cannot be on at the
same time, -singletask would take precedence.
3.3 Single save
The default status of the Single save button in the split window may be
set. Edit the !Run file as above and add or remove -singlesave. For
example, to have single save on, your Run command may now look like this:-
Run <Split$Dir>.!RunImage -faster -singlesave %*0
3.4 Filesize
To set the default filesize, edit the !Run file as above and add the
following option to the Run command:-
-filesize n Where n is the filesize in K (1024 bytes).
For example, your Run command may now look like this:-
Run <Split$Dir>.!RunImage -faster -singlesave -filesize 713 %*0
The size is now suitable for saving to double density DOS formatted floppy
disks.
3.5 Filesize menu
The filesize menu may also be customized. To do this, open the Resources
directory, and load the SizeMenu file into a text editor. The file is made
up of two columns, the first is file size in Kbytes, the second (which is
optional) is the text which will appear in the filesize menu. If only the
file size number is used, then that number will appear in the menu.
The next time you start !Split, it should read in your new menu.
4 History
Versions 1.xx are command line versions, which are supported along side the
desktop versions (2.00 and greater).
• Version 1.00-1.08 These were the original command line versions compiled
on several different computers.
• Version 1.10 This version has a new file format, a header is put at
the beginning of each part, and is used to join files in
the correct order. This version is compatible with the
desktop version (2.00 and greater).
• Version 1.11 Slightly increased memory allocation for filenames, and
added a small check needed for DEC Ultrix compilers.
• Version 1.12 Added -interactive option to allow direct reading and
writing of floppy disks. This option enables different
paths to be given for each part, removing the need, for
example, to load all the parts onto the hard disk before
joining.
• Version 1.12c Supports official Acorn filetype.
• Version 1.13 Modified the Acorn specific bits to speed up file
access. Also tidied and commented the code a lot more.
NOTE: The only executables changed from version 1.12
are the Acorn ones, therefore I have only compiled
this version for these machines.
• Version 2.00 First desktop version.
• Version 2.01 Added ability to open join window with the Adjust
button, and to drag files to the window. This made it
easier to start the joining procedure if the files
aren't filetyped as 'Split'. Fixed bug with ArcFS image
file system doesn't complain about archives any more.
• Version 2.02 Added filesize menu, fixed a few small bugs.
• Version 2.10 Big jump from 2.02 to 2.10 because I decided to
completely re-write the program from scratch without the
use of RISC_OSLib functions. This has made the program
easier to write, control, modify, and has made the code
smaller and it also runs faster.
• Version 2.11 Added multi-tasking option. Fixed a few small bugs.
• Version 2.11c Fixed menu item height. As of this version, !Split uses
an official Acorn filetype.
• Version 2.12 Speeded up file operations. Increased the amount of data
transferred each WIMP Poll. More meaningful text in the
size menu. Added ability to skip parts when splitting.
New option to autoload join parts.
• Version 2.12d Bug fixes.
5 Files supplied
The following files are supplied inside the !Split application directory.
!Boot
!Help This file.
HelpPS PostScript version of this file.
!Run
!RunImage Main program.
!Sprites, !Sprites22
Resources (directory) Contains ...
SizeMenu Definition of the filesize menu (see section 3,
'Customizing').
Toggle3D Toggles the state of the 3D bit in CMOS RAM.
ToggleDRAG Toggles the state of solid dragging bit in CMOS RAM.
Template2D 2D window templates.
Template3D 3D window templates, RiscOS 3 or greater.
The program will automatically select the correct templates file to use.
6 Acknowledgments
I would like to thank Andrew Sellors for his suggestions and help in testing
this application.
Thanks to Sergio Monesi for his suggestion on speeding up file operations.
================================================================================